home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / clue.lha / clue / doc / clue.tex / node242_mn.html < prev    next >
Text File  |  1989-07-12  |  4KB  |  120 lines

  1.  
  2. <H3><A ID="SECTION006811100000000000000">
  3. Resource Databases</A>
  4. </H3><#5364#>
  5.            
  6.       
  7.  
  8. This section summarizes the features of an <#3350#><TT>xlib:resource-database</TT><#3350#>.
  9. See [#xlib#<tex2html_cite_mark>#1##<tex2html_cite_mark>#] and [#clx#<tex2html_cite_mark>#1##<tex2html_cite_mark>#] for a complete description of CLX resource
  10. management.
  11.  
  12. <P>
  13. Conceptually, a resource database is a set of resource name-value pairs (or 
  14. <#3353#><B>resource bindings</B><#3353#><A ID="3354"><tex2html_anchor_invisible_mark></A>). Some examples of resource
  15. bindings are shown below. In these examples, we assume that <#3355#><TT>mail</TT><#3355#> is the
  16. resource name of a mail reading application; <#3356#><TT>mail</TT><#3356#> uses a contact of the
  17. class <#3357#><TT>button</TT><#3357#> whose name is <#3358#><TT>reply</TT><#3358#>.
  18.  
  19. <P>
  20. <DIV class="CENTER">
  21. <TT></TT><TABLE CELLPADDING=3>
  22. <TR><TD ALIGN="LEFT"><TT>
  23. </TT> Resource Name<TT> </TT></TD>
  24. <TD ALIGN="LEFT"><TT> </TT> Resource Value<TT></TT></TD>
  25. </TR>
  26. <TR><TD ALIGN="LEFT"><TT> 
  27. </TT></TD>
  28. <TD ALIGN="LEFT"><TT></TT></TD>
  29. </TR>
  30. <TR><TD ALIGN="LEFT"><TT> 
  31. (mail screen-1 reply background) </TT></TD>
  32. <TD ALIGN="LEFT"><TT> 'green</TT></TD>
  33. </TR>
  34. <TR><TD ALIGN="LEFT"><TT> 
  35. (mail * background)       </TT></TD>
  36. <TD ALIGN="LEFT"><TT> 'red</TT></TD>
  37. </TR>
  38. <TR><TD ALIGN="LEFT"><TT> 
  39. (* button background)     </TT></TD>
  40. <TD ALIGN="LEFT"><TT> 'blue
  41. </TT></TD>
  42. </TR>
  43. </TABLE><TT>
  44. </TT>
  45. </DIV>
  46.  
  47. <P>
  48. These resource bindings specify that the background color resource of
  49. <#3366#><TT>mail</TT><#3366#>'s <#3367#><TT>reply</TT><#3367#> button has the value <#3368#><TT>green</TT><#3368#> on <#3369#><TT>screen-1</TT><#3369#>, that
  50. the background color for the rest of the <#3370#><TT>mail</TT><#3370#> application is always <#3371#><TT>red</TT><#3371#> on all screens, and that, in general, the background color for all <#3372#><TT>button</TT><#3372#>
  51. contacts is <#3373#><TT>blue</TT><#3373#>.  Thus, the name in a resource binding is a list
  52. of symbols (or strings) which are hierarchically related in a way that
  53. corresponds to
  54. a path down a parent-child tree of contacts.  The name can be a partial
  55. (or incomplete) path, can use ``wildcarding'' for partial paths, and can include both
  56. resource names and contact class symbols at any position.
  57.  
  58. <P>
  59. A user can establish 
  60. resource bindings in a resource database by using the <#3374#><TT>define-resources</TT><#3374#>
  61. macro or the <#3375#><TT>xlib:add-resource</TT><#3375#> function.
  62. The <#3376#><TT>describe-resource</TT><#3376#> function may be used to print the values in a
  63. resource database associated with a given name.
  64. It can also be useful to process the set of resource bindings in a resource
  65. database (for example, to save them to a file). The
  66. <#3377#><TT>xlib:map-resource</TT><#3377#> function is designed for this purpose.
  67.  
  68. <P>
  69. <#4513#><FONT SIZE="+1"><#3378#><B>define-resources Macro</B><#3378#></FONT><#4513#> 
  70. <A ID="3379"><tex2html_anchor_invisible_mark></A>
  71. <DIV class="RIGHT">
  72. <tex2html_image_mark>#tex2html_wrap_inline10494#
  73. </DIV>
  74.  
  75. <P>
  76. <DIV class="RIGHT">
  77. <tex2html_image_mark>#tex2html_wrap_inline10495#
  78. </DIV>
  79.  
  80. <P>
  81. <#4516#><FONT SIZE="+1"><#3393#><B>undefine-resources Macro</B><#3393#></FONT><#4516#> 
  82. <A ID="3394"><tex2html_anchor_invisible_mark></A>
  83. <DIV class="RIGHT">
  84. <tex2html_image_mark>#tex2html_wrap_inline10496#
  85. </DIV>
  86.  
  87. <P>
  88. <DIV class="RIGHT">
  89. <tex2html_image_mark>#tex2html_wrap_inline10497#
  90. </DIV>
  91.  
  92. <P>
  93. <#4726#>
  94. <#4519#><FONT SIZE="+1"><#3408#><B>describe-resource Function</B><#3408#></FONT><#4519#> 
  95. <A ID="3409"><tex2html_anchor_invisible_mark></A>
  96. <DIV class="RIGHT">
  97. <tex2html_image_mark>#tex2html_wrap_inline10498#
  98. </DIV><#4726#>
  99.  
  100. <P>
  101. <DIV class="RIGHT">
  102. <tex2html_image_mark>#tex2html_wrap_inline10500#
  103. </DIV>
  104.  
  105. <P>
  106. <#4727#>
  107. <#4522#><FONT SIZE="+1"><#3424#><B>*database* Variable</B><#3424#></FONT><#4522#> 
  108. <A ID="3425"><tex2html_anchor_invisible_mark></A><A ID="3426"><tex2html_anchor_invisible_mark></A>
  109. <DIV class="RIGHT">
  110. <tex2html_image_mark>#tex2html_wrap_inline10501#
  111. </DIV><#4727#>
  112.  
  113. <P>
  114. <DIV class="RIGHT">
  115. <tex2html_image_mark>#tex2html_wrap_inline10504#
  116. </DIV>
  117.  
  118. <P>
  119.  
  120.  =0 <#5370#>=0 <#5374#>